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1 INTRODUCTION 


Features 


1. Natural speech 

2.Allophone synthesis 

3. Uniimited 

4. Audio mixer for stereo sound rom CPC464 

‘5. Stereo output, 200mW per channel into 4 chms 

6. ‘Through Bus' for peripheral ‘daisy chaining’ 

7. Nine extra commands including Text to Spsech conversion 

‘8. interupt driven speech output butter 

‘The Amstrad SSA1 combined speech synthesiser and amplifier represents the latest state of the art in speach synthesis for the home 
micro. 

Until recently most speech synthesisers coud only manage a limited range of words, decided upon during manufacture. This was fine it 
the word you wanted to say whet was available. In contrast, the SSA1 can say any word or sentence in the English language. it does this 
‘by using a combination of discrete speech scunds called allophones. By combiningallophones together inteligible speech is produced. 
The SSA7 also incorporates a sophisticated Text to Speech conversion system that allows most arbitrary English text to be spoken 
automatically. stereo amplifier ensures crisp speech whist allowing fll use to be made othe CPC464's stereo sound. 


2 SETTING UP THE SSA1 


2.1 Installing the Hardware 


Ensure that the computer and any other peripherals are switched off before connecting the interface. Connect the speakers into the 
‘sockets either side ofthe interface. When viewed from the rant, the left speaker goes into the socket on the let hand side of the interface, 

Plug the interface into the Floppy Disc expansion port, then plug any other peripherals (disc drive|into the back of the SSA. 

‘A fying lead is provided to connect the SSA? to the stereo sound output of the CPC464, allowing all sound output to be heard via the 


‘stereo speakers. Connect the flying lead into the stereo sound output socket next to the joystick socket, on the left back edge of the. 
‘computer. Tum the volume control onthe right hand side of the interface to its central position, 


‘Apply power to any peripherals and then switch on the computer, Press the green [DEL] key. Abeep should be heard on both speakers., 
Re-adjust the volume controito suit. 

When the SSA is connected the intemal loudspeaker of the compute is muted, athough the leading of cassette programs may stile 
heard 2s normal through the intemal loudspeaker. 


‘22 Loading the Operating software 


Beforeany speech can be generated the software supplied must be loaded into memory. Insert the tape and type: 


RUN "SSA1 [ENTER] 


{nitalya short BASIC loader program willrun that checks the SSA hardware, I the hardware is faulty or not attached tothe expansion 
port the message: 


SSA1 hardware not operational 
willbe displayed andthe program will end, 


Otherwise a message asking forthe address at which to load the software willbe displayed. I you do not know what load adress to use, 
simply ype [ENTER] on its own, the software wil then be loaded atthe top of memory. The load address entered must be above 16364 
and beow HIMEN. The program wil tll ou how much memory is quired by the software, Note that HIMEN will beset to prevent 
BASIC ftom using the same memory. 


After the load address has been entered the main SSA1 software willbe loaded. When complete the message 
‘The speech synthesiseris now ready foruse. 
Ifyou attempt to load the SSA 7 software in more than once, the message: 


SSA1 software already loaded. 
willbe spoken and displayed. 


‘The SSA1 software you have just loaded isa special kind of machine code program. It allows extra commands for speech to be usedina 
BASIC program. Touse the commands you simply typin their name (s0e Getting Started) together with anyother variables as needed. 


‘The SAT software remains in memory, even after a NEW command, until a reset is performed, (using [CTRL] [SHIFT] (ESC). In other 
‘words, the only timethe SSA software has tobe installedis when the machineis switched on or reset. 
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io should be heard, 


2.3 Precautions inUse 
The following precautions should be observed. 


‘Always ensure that the computer and any other peripherals attached on the through bus (disc drives etc.) are switched off before 
connecting or disconnecting the interface. 


Never short circuit the loudspeaker outputs for long periods of time. 
Donot use loudspeakers with a lower impedance rating than 4 ohms per channel. 
Loudspeakers generate magnetic fields. ALWAYS ensure that discs and cassettes are kept well away from the loudspeakers. 


Never place the loudspeakers near the monitor screen, never place them on top of the monitor. (Permanent picture or colour distortion 
‘may result due to the magnetisation of part ofthe screen) 


3 GETTING STARTED 


The SSA1 software provides nine external commands allowing speech to be generated for any application, the commands are: 


ISAY ,@STRING VARIABLE: 
TECHO ,-MODE- 


1QureT 
TAPHONE , INTEGER VARIABLE: [,INTEGER VARIABLE}) 
IROOM, aINTEGER VARIABLE» 


ISPON 
ISPOFF 


ISPSTATUS,@NTEGER VARIABLE 
ISPOUT «INTEGER VARIABLE: (INTEGER VARIABLE] 


‘Chapter 8 describes these commands in detail. The next section presents a few simple examples demonstrating how easy the SSA1 isto 
use. 


3.1 Simple Words and Phrases 


‘The SSAI contains a Text to Speech system that looks at text and converts characters into allophones, the fundamental sounds of 
speech, that the SSA hardware can understand. 


Two commands | SAY and 1 ECHO perform text to speech conversion. The | SAY command takes a string and says it. The |ECHO 
‘command can be set to look at text printed to the screen, so that istings and printed characters canbe heard. 


‘Type NEW and then the program: 


1@ a$="simple words” 
20 ISAY,aa$ 


(The | character can be obtained with [SHIFT] [@)) 


Now RUN the program and observe what happens. The program finishes before all the words are spoken. The software uses a speech 
‘queue, which works ina similar way to the BASIC SOUND queue. Essentially it allows the allophones to be spoken in order, transparently 
from BASIC. in other words it allows BASIC to continue a program without having to wait for speech to finish. The queue has room for a 
‘maximum of 64 allophones, around 8 seconds of speech. If there is no room left in the queue then the I SAY and 1 ECHO commands 
will wait forroom to be made, itis only then that BASIC will pause, until all the speech has been sent tothe buffer. 


‘The string used with 1 SAY can contain any of the 256 ASCII characters, some characters suchas + - & arespoken, whilst others 
lke Care ignored. For afuler explanation of the Texto Speech system refer to Chapter 5. 

The | ECHO commandis intended for saying phrases normally sent tothe screen. 

Type inthe program: 


10 1ECHO,1 

20 INPUT "'How old are you ‘";ageS 

38 PRINT "'You are";age$;" years old!" 
40 1ECHO,O 
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Line 10 instructs the SSA1 to say text printed to the screen between the celimiters (2), line 40 reverts printing back to normal, The (:) 
characteris obtained with [SHIFT] [\], the key immediately above the green [CTRL] key. 


RUN the program and enteryour ageas a number. Notice that numbers are spoken exactly as you would expect. Now type in 


TECHO,3 
LIST 


Theprogram willbe isted and spoken, in fact anything printed by BASIC including syntax errors, messages etc. willbe spoken, To cancel 
the speech echo enter: 


TECHO,® 


Hereare some more examples: 

1. Say the alphabet 

10 FOR Letter = ASC("A") TO ASC("Z") 
20 aS=CHRS( Letter) 


30 ISAY, das 
40 NEXT 


2 Say the numbers 1 to 10 
18 1ECHO,3 

20 FOR number = 1 to 10 
30 PRINT number 

40 NEXT 

50 1ECHO,D 


Youshouldnow be ableto use speech from within any of your programs, for more details ofthe commands referto Chapter 8. 


‘3.2 Loading and Saving BASIC Programs 
Essentially there is no difference between the way programs are normally loaded or saved, and the way they are loaded or saved with the 
‘SSAT installed, However, the the SSA software must always be installed, es outlined in section 2.2 after switching on, or resetting, the 
computer. 
Your BASIC programs can be saved as usual with the SAVE command, For example: 


SAVE "MYPROG" 


‘When LOADing programs that use the speech commands you must ensure that the SSA? software has been installed firs, otherwise 
the speech commands will not be present, and BASIC will give an error message when the program is run. Remember, the SSA7 
softwareis installed as explainedin section 2.2. 


Atterinstaling the SSA, your BASIC programs maybe loadedaas usual with the LOAD command, forexample: 
LOAD “MYPROG" 


‘98.3 Experimenting with sounds 
‘The English language has many imegulations in prenounciaton for example “Cough”, “bough”. The SSAI software contains a large 
number of pronounciationrues but sometimes it willbe necessary to experiment with character speling to achieve the exact esuts. 
Cough = COF 
Bough = BOUH 


4 ALLOPHONES 


‘As mentioned previously, the Text to Speech system converts tex into allophones. itis not possibleto convert every word successfully 
into the correct allophones because of the many speling-pronunciation regularities in the Engish language. To allow dffcut words to 
be sroken correctly, the | APHONE command can be used to speak allophones chosen by yourset. 

‘TypeNEW and then this program: 


10 1sPON 
20 IAPHONE,42,15,16,9,49,22,13,51,3 

‘When the program is RUN the word computer is spcken. The numbers after the | APHONE command are the allophones that make the 
‘word computer. Each allophone is stored in tum in the speech queue, ready tobe spoken. Unlike the I SAY and | ECHO commands the 
allophones are not spoken immediately, but wait forthe speech queue tobe turned on wth the command | SPON. Oncathe speech 
{queue ison, any furthor alophones wil be spoken unt the queue is tuned of, or held, wth I SPF F To demonstrate the queueing 
effect, changeline 1B to: 
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10 ISPOFF 
‘This time when the program is RUN nothing is heard. Thisis because the queue is held. Now type in: 


ISPON [ENTER] 
‘Computer should now be heard. More information on these commands can be foundin Chapter 8. 


4.4 The Allophone Set 


‘There are a total of 59 allophones and 5 pauses available on the SSAI. To use the allophone set successfully to synthesise words, the 

following points should always be 

1. Speech sounds do not always appear acoustically the same, they may be spoken differently, even within the same word. 

2. Like the pieces of a Jig-saw puzzle, the speech sounds are separate. Combinations of them must be used to make up the entire 
‘picture’ of how a word sounds. 

3, The letters of the alphabet do not have their own speech sound. Each letter may be spoken in a different way depending upon its 
position within a word. 


oilustrate these points try saying the following words one atte another: 
call cup coop 


You should fee the point of contact between the back of your tongue and the roof of your mouth move futher back for each successive 
‘c’ sound. 


The'c’ at the start of each word is known as a phoneme. Phonemes themselves cannot be spoken. When the word is spoken a cifferent 
‘sound ofc’ is produced, and these different sounds are known as allophones. Thus allophones are different ways of saying phonemes. 
Most phonemes are influenced by other phonemes around them, and this is why the same letter within a different word can make @ 
different sound. 


‘Theallophone set (see Tables 4A and 4B) contains two or three sounds of some phonemes. It may be necessary to use one allophone of a 
particular phoneme at the start of a word or syllable, and another for the end of a word or syllable. A detailed set of guidelines for using the 
allophones are given in Table 4B. Note that these are suggestions, not rules. 


‘Asan example, /DD2/ sounds good in an initial position and /DD1/ sounds good in final positions, lke in ‘daughter’ and ‘collide’. One of 
the differences between the initial and final versions of a consonant may be that an initial version is longer. Therefore, to create an initial 
/SSi/, two /SS/s can be used instead of the usual single /SS/ at the start of a word or syllable, as in ‘sister’, Note that this canbe done with 
TH, and /FF/, and the inherently short vowels (refer to Table 4B), but with no other consonants. 


Generally itis best to experiment with some consonant clusters (strings of consonants such as strc}, in order to discover which version 
‘works best inthe cluster. 


For example /KK1/ sounds good before /LL/ as in ‘clown’, and /KK2/ sounds good before /WW/ as in ‘square’. One allophone of a 
particular phoneme may sound better before or after back vowels and another before or after front vowels. The /KK3/ allophone sounds 
good betore /UH/, and /KK1/ sounds good before /IV/, asin ‘cookie’. 


‘Some sounds /PP/ /BB1//BB2//TT1/ /TT2/ /DD1/ /DD2/ KK 1//KK2/ /KK3/ /GG1/ /GG2/ /GG3//CH/ and /JH/) require a orief duration of 
silence before them. For most of these, the silence is included in the allophone, but more may be added as desired, The pauses PAT to 
PAS may be used to provide silences of the appropriate duration. 


When using alophones always think about how a word SOUNDS, not how itis spelt. For example, the /NG/alophone obviously belongs 
atthe end ofthe words ‘sing’ and long’, but notice that the /NG/ sound i represented by the letter N in ‘uncle’. Some sounds may not be 
represented in words by any letters, such as the /YY/ sound.in ‘computer’ 


‘Most vowels can be doubled to make longer versions for stressed syllables. These are the inherently short vowels /IH/, /EH/, /AE/, /AX/, 
INN), and /UHY. For example, in the word ‘extent’ one /EH/ is used in the first syllable, which is unstressed, and two /EH/s are used inthe 
second syllable, which is stressed. One of the inherently long vowels has a long and short version. ‘The short one /UW1/, sounds good 
ater ¥Y/in computer’. The long version, /(UW2/, sounds good in monosyllabic words like "two! 


Included in the vowel set is a group called R-coloured vowels. These are vowel plus R combinations. For example, the /ARY in ‘alarm’ and 
the /OR/ in ‘score’. Of the R-coloured vowels there is one which has a long and short version. The short version is good for polysyllabic 
‘words wth final /ER1/ sounds lke ‘te’, andthe long versions good for monosyllabic words lke“ 


One final suggestion when creating sentences is to add a pause of 30-50msec between words and a pause of 100-200msec between 
sentences. Always remember to send a pause after the final llophone to suppress the last sound made by the speech synthesiser. 


4.2How To Use The Allophone Set 


‘Table 4A should be used initially when trying to split words into their allophones. The allophones given, make the sound ofthe letters, and 
they canbe used to make up any word nthe English language. 


For example to find the allophones for the word ‘helio’ start with the first letter ofthe word, thinking about how the word sounds. The frst 
letter is ‘h’, and the allophone for ‘h’ is 27. The next letter is‘e', and its allophone is 7. The double 'l' sound can be made with (il, whose 
allophone is 62, The ‘o’ at the end of the word makes the sound like the letter ‘O” in the alphabet, the same sound is also made by (eau), 
whose allophone is 53. Lastly all the allophones must be put into order followed by @ pause, a short pause PAI is ideal. The 
corresponding | APHONE command would be: 
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IAPHONE, 27,7,62,53,0 
For more complicated words that sound ‘funny’ it may be necessary to refer to table 4B in addition to table 4A for extra informationon the 
use of a particular alophone. 

TABLE 4A - Quick Guide to the allophones 

T 


Sound | Allophone | Seetionintable 48 
a 4 42.11 
b 8 48.51 
c 8 48.52 
4 a 48.51 
e 7 “Bn 
f 40 48.42 
9 36 48.51 
h 2 48.42 
i 12 48.11 
ij 10 48.2 
k 2 48.52 
i 45 483 
nm 16 486 
n "1 486 
° 23 48.11 
P 8 43.52 
r 39 483 
s 55 48.42 
t 7 48.52 
u 15 48.11 
v 35 48.41 
w 6 483 
y 49 48.3 
z a 48.41 

(cavlay) 20 48.12 
(ee) 19 48.12 
(i) 6 48.12 
(ooyfeau) 53 48.12 
(bo) 83 48.51 
(6) 3 48.51 
(99) at 4851 
(990) 4 4851 
(on) 57 48.42 
iO) 82 483 
(on) 56 4B6 
cu) 4 48.3 
(t) 8 48.52 
7) % 48.3 
ar) 59 4B.13 
(ae a7 48.13 
(ch) 50 48.2 
(oh) “4 48.52 
(ean “60 48.13 
(en) 6 48.11 
(er St 48.13 
(er) 52 48.13 
(09) 4 486 
(on 58 48.13 
(ou) 2 48.12 
(ow) uf 48.12 
(ow) 2 48.12 
(oy) 5 4BA2 
(sh) a 48.42 
(tn) 9 48.41 
(ath) 18 4B.41 
(uh) 0 4B.11 
(wh 8 48.42 
eh) 38 4B.41 
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TABLE 4B - Allophones by letter group 


48.1 VOWELS 
48.11 Short- These allophones canbe doubled 
Address: ‘Sounds-ike Example & when to use Vowel Type 
e bEnd Mid front 
i fitting High front 
u sUcceed Mid central 
° sOng Low back 
a hot Low central 
eh End Low front 
00 High Back 
48.12Long 
290mS oy toY Midback 
170mS i SkY Low central 
170mS ee stE High front 
200m aalay gfEAt Midfront 
60mS ou 0 High back 
170mS ‘ouu monosyilabic 00d High back 
250mS ow Out Low central 
170mS o/eau snOW Midback 
aer repalR Midfront 
er lettER Mid central 
er monosyllables: bIRG Mid central 
or stORE Lowback 
a tARm Low central 
ear CIEAR High ront 
‘Sounds-like Example & when to use 
i Jury 
ch CHurch 
‘Alophone Duration Sounds-ike Example & when touse 
RR 130mS . Initia postions: Read 
(RRQ) 80mS r Initial clusters: bRown 
NY mS y Initial clusters: Ute 
ya) 130mS w Initial postion: Yes 
1 helLo 
f) angle 
w We 
Example & when touse 
Initial positions of words: THey 
Final positions and between vowels: baTHe 
Vest 
200 
beiGE 
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48.42 Voiceless 


29 TH 130mS) th Thin 
0 IPE) toms f Fie 
5 ISS) coms 8 Sat 
(29,40,55 may be doubled for Initia positions and used singlyin final postions) 
Ff a THI $0ms h before ront vowels: Head 
57 MHD 190m hh before back vowels: Hoe 
37 SH 120mS sh Hit 
8 ‘WH 150ms, wh Weim 
. AB5STOPS 
48.51 Voiced 
"Address | Allophone Duration Sounds-lke | Example& whentouse 
28 (BB 40m b 8 
63 1882/ 6oms bo Initia positions before vowels: Bug 
2 101 ams r] Final positions: enD 
33 mp2 Boms od Initial positions andin cluster: Down, Drain 
6 IeGi/ ‘oms. 9 Before high ront vowels: Guest 
6 16G2/ BomS. 9 Before high back vowels: Go; and clusters: Green 
4 1663 120mS 999 Ba on vw: ot nal cts Ged 
positions: peG 
48.52 Voiceless 
7 iY Am 80nS, t Final clustersbetoe/SS/:iTs 
a3 | ma 100mS tt To 
4 | ikki 420mS k Betore front vowels: Computer 
at | KKa/ 140m ok Final positions: speak Final clusters: sKy 
8 IKK3 80mS ik Before back vowels: Cock; and inital clusters: Crane 
1 9 PPL 150mS P Pub 
4B.6NASAL 
< ‘Aaaress | Allophone Duration Soundske | Example&whentouse 
16 MI 180mS m Mik 
1" INNI/ 1T0mS A Before front andlow vowels: Nice; Final clusters: earN 
56 INNO) 140mS on Beforeback vowels: Noise 
: 44 ING) 200mS 0g aNGer 
48,7 PAUSES 
[address | Allophone Duration Example when touse 
0 PAI toms Use before voiced stops and /JH/,or asan apostrophe () 
1 PA2 30ms Use before voiced stops and /JH/,oras acolon ()or semicolon) 
2 PAS 50mS Use before voiceless stops, and /CHY, and between words, oras spaces 
3 PAS +06mS Use between phrases or as acomma () 
4 PAS 200mS Use between sentences or asa period) 
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5 TEXT TO SPEECH 


The commands ISAY and ECHO incorporate a sophisticated text to speech system capable of converting most commonly 
‘occurring Engish text into allophones. The allophones represent the individual speech sounds that are found within words and are 
‘output tothe SSA1 speech synthesiser hardware, to produce speech corresponding to written text. 


‘The text to speech system uses the principle of Synthesis-by-Rule. This actually involves two separate tasks. The frst task consists of 
textinterpretation, the second the application of phonological rules. 


Text interpretation is a non-trivial task. The speling system of madern day English is awkward and sometimes confusing, as any 
‘school child might be aware. Words that sound the same may be spett differently, like ‘here’ and ‘hear’, and equally words that sound 
<iferently may be spelt the same. For example ‘lead’ as in ‘Lead us not into temptation’ verses ‘lead weight’ meaning the metal 
Similarty ‘ive’ as in lve wire’ verses ‘ive a long time’. The only real solution to this problem would require a database containing the 
meanings of words. The context of the phrase could then be determined and the correct pronunciation deduced. Unfortunately this 
approach is restricted to mini-computers rather than personal computers. Text interpretation in the case of the SAI is therefore 
restricted to the identification of word boundaries, the recognition of symbols and abbreviations, such as ‘a and ‘Dr’, and the 
conversion of numbers. f one spelling of a word sounds incorrect then ty its alternative, or experiment with misspeling the word. 


‘Once the input text has been identified a set ofrules are applied to determine the corresponding allophones fora given etter group within 
‘awword. The same letters may have different sounds depending where they occur within a word. Unfortunately the English language has 
many speling peculanties that are capable of deluding any logical set of rules. Infact some of the most common words contain blatant 
Violations ofthe general rules. An instructive ilustation of this comes from George Berard Shaw, who used the letters ‘ghoti'to spell 
“fish, taking ‘gh’ from ‘cough’, 'o" from ‘women’, and't from ‘nation’. 

Inorder to make use ofthe speling rues the English language does have, without causing havoc with those words that defy the rues, an 
exceptions dictionary is used that contains the correct set of allophones for troublesome words. Some of the BASIC keywords are 
examples of exceptions, the command CREAL, for instance, is actually pronounced ‘c’ followed by ‘rea’. For this reason the 
allophones for some keywords are held in the exceptions dictionary to prevent the word being said literally, and therefore sounding 
incorrect. The list of possible exceptions can be quite large and consequently the SSA 7 only has alimited set. Any words that stil sound 
incorrectly may be tackled by spitting them into thet allophones, as outined in Chapter 4. 


5.1 Recognised Abbreviations 


ok 

BBC 

™ 

Dr. ‘doctor’ 

Mc ‘mister 

Mrs ‘misses’ 

aes < 

pm 'p' ‘mv’ 

5.2Spoken Symbols 

‘Symbol ASCII Textspoken 
# 23H ‘hash’ when not followed by a cigi,‘pounds’ # immediately followed by a digit 
$ 24H ‘string’ when not followed by a digit, ‘dolars’ if immediately followed by a digit 
x 25H ‘percent’ 
& 26H ‘and’ 
* 2AH ‘times’ 
+ 28H ‘plus’ 
- 20H ‘minus’ 
7 26H ‘point’ i followed by a digit 
/ 2FH “divided by’ 
< 3CH ‘less than’ 
= 30H ‘equals’ 
> 3H ‘greater than’ 
a 4H ‘at’ 
\ 5CH ‘divided by’ 
t SEH ‘power 
I 7H "ba 


The ASCII characters 23H ('#” pound or hash), and 24H (‘$' dollar or string), are pronounced differently depending upon their context. If 
the characters are followed by a digit then the characteris not spoken unt the following number has been said. The character then takes 
‘onamonetary role and is pronounced ‘dollar’ or ‘pound’. 
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Example: 


145 will say ‘forty five pounds’ 


458 will say ‘forty five hash’ 
#45 will say ‘hash forty fve" 
$45 will say ‘forty five dollars’ 


458 will say ‘fory five sting’ 
$45 will say ‘string forty five’ 


The ASCII character 20H is always spoken as ‘minus’. this characteris occurs asa hyphen between two worcs it will also be spoken as, 
‘minus’ 


Letters, symbols and numbers may be combined to form mathematical equations and so on; 


34(1/2)23.5 spoken as ‘three plus one divided by two equals three point five’. 
a=34tb spoken as ‘a equals thily four plus b’ 
BBC2 spoken as ‘b b c two’ 

5.3Numbers 


The text interpreter will say numbers less than ten digits in ful, numbers of more than nine cigits will have each digit spoken separately. 
Any leading zeros willbe suppressed, except for zeros encountered attera decimal point. Numbers longer than 40 digits willbe spit-up 
into sections of 40 digits and each section willbe treated separately. 


123456789 ‘spoken as‘one hundred andtwenty three milion four hundred ancfift si thousand seven hundred and eighty 
nine’. 
9090001 spokenas‘one’ 
800002.002 ‘spoken as ‘two point zero zerotwo’ 
4990919191 ‘spoken as ‘one one one one ong one one one ore one’ 
S4Letters 


‘The ASCII characters A-Z (41H to SAH) and a-z (61H to 7AH| inclusive, are interpreted by a set of phonologicalrules. Words greater than 
40.characters willbe split-up into sections of 40 characters, and said separately. 
5.5TextDelimiters 


‘Al the punctuation symbols, tabs, spaces, carriage returns and line feeds are used to determine word boundaries. More than one: 
‘occurrence of a space, tab or newine characteris igncred, $o that pauses do not seem too long. For example the following two Ines wilt 
both have the sare pause between the words. 


Hello there! 
Hello there! 


Allother characters, including graphics, control codes (except for those used to determine word boundaries) and unpronounceable 
symbols, such as brackets, are ignored, 
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6 EXAMPLE PROGRAM 


6.1 The Speaking Clock 


This example program shows how simply text to speech may be incorporated within a program. The | ECHO command is used to read 
aloud the input prompts, whilst | SAY is used to speak the time. The time is spoken every fe seconds, using atwelve hour cycle. 


Before using the program, frst make sure that he SSA softwares installed. 


10 REN *##x%* The Speaking Clock *#xx##* 


20 REM 

30 REN *#x*4* Assumes the SSA1 code has been loaded 
40 REN 

50 REM *##x** Twelve hour cycle. Time spoken every 
60 REN five seconds 


SECSS=SECS+"s" 


: PRINT 
138 INPUT ""Enter the time in HOURS,MINS *";HH,MM 
140 IFHH>120RNM>68 THEN 136 


15 

160 MODE O 

170 PEN 3: PRINT "*The Speaking Clock’: PEN 1 
188 1ECHO,8: GOSUB 270 

198 EVERY 258 GOSUB 219 

2008 WHILE -1: WEND 

210 REM #4#+% Update the time t#tsteaxsaee 
226 SS=(SS+5) MOD 60238 IF SS<>@ THEN 270 
268 MM=(MM+1) MOD 60 

256 1F MM<>B THEN 270 

268 HH=(HH#1) MOD HOURS 

278 LOCATE 7,11 

280 IF HH=O THEN HH=HOURS 

290 PRINT USING "##:##:#H";HH;MM; SS 

308 HS=STRSCHH): ISAY,3HS 

310 IF MM=@ THEN ISAY,20$: GOTO 330 

326 MS=STRS(WM): ISAY,aNS 

330 1F SS=6 THEN ISAY,aPS: RETURN 

348 ISAY, AAS 

G 358 SS=STRS(SS): ISAY,2S$ 

360 IF SS>1 THEN ISAY,aSECSS ELSE ISAY,aSECS 
370 RETURN 

500 PRINT: PRINT "The SSA1 software has not been loaded” 
510 PRINT: END 
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7 ADVANCED COMMAND OVERVIEW 


‘The SSA1 software provides nine external commands that are usable from BASIC programs. The commands aren the form of Resident 
System Extensions (RXs) that must be loaded into memory, before they can be used. The FSXs are fully relocatable, and perform their 
‘own ntialistion. Asimple LOAD anda ALLL from BASIC sallthatis required to introduce the commands and initialse the SSA. 


Inocderto utilise he SSAt software to the flit is necessary to know how the commands workand what they do. The folowing sections 
etailinecommands. 


7.1 Hierarchy of Commands 


There are four levels of hierarchy, these include lw level mare drivers that address the speech processor direct, interupt driven 
allophone buffers, and text o speech conversion. The hierarchical diagram below summarises the levas. Each levels intended fora 
particular application. Itis not recommended that the commands from levels 3, 2 and 0 be used simultaneously. 


LEVELS TEXTTO SPEECH ae 
laurer 
Level2 ALLOPHONE BUFFER IAPHONE 
1ROOK 
Ison 
LEVEL INTERRUPT EVENTS Isporr 
IsPsTATUS 
LEVELO HARDIARE DRIVERS. ISPouT 


7.11 LEVELS-Textto Speech Conversion 


This isthe highest level where ASCII tec is converted into allophones by using a sophisticated Text to Speech system. The allophones 
produced are subsequently sent to level 2, the inter driver allophone buffer. When the the buffer becomes full, the commands atlevel 
‘suspend BASICuntiallthetext has been converted. 


‘7.42 LEVEL2- Interrupt Driven Allophone Buffer 


This butferis used to temporarily queue upto 64 allophones that are to be output tothe speech processor. Is main purpose is to allow a 
foreground program to cortinue operation, whilst interupt events ensure that any data, from the buffer, is output to the speech 
processor atthe appropriatetime, 


‘Tne buffer can be filed from level 3 or by the command | APHONE at kvel 2, either source may insert allophones at any time into the 
buffer. ifthe buffer becomesfulithen the | APHONE command will discard any alloghones thatcannot be stored. 


‘The command 1ROOM may be used whenever it is necessary to determine the number of spaces left in the buffer. Some status 
information relating olevels and Oarealsoreturned by | ROOM. 


‘Any detain the buffer may be flushed, and a pause sentto the speech processor withthe command | QUIET. 


‘Thebuffer can only be emptied by speech interrupt events occuring at evel 1. thespeech interupts are off then thebutfer wil flup.To 
allow text to speech to operate conectly the |ECHO and ISAY commands automatically enable the speech interrupts. The 
TAPHONE command does not change the state of the interupts, so care must be taken not to lose allophones if | APHONE is used. 
‘when the buffers full. 


.ASLEVEL 1- Speech interrupt Events. 
‘An event may be set up using | $ PON. This eventreads characters from the allophone butfer and sends them to the speech processor. 
‘The event may be disabled at any time with | SPO F, this prevents ary more characters being read fram the butter and also sends a 
ppauseto the speech processor, to ensure thatthe last allophone isnot scunded for ever. When the event is disabled the butterisleftinits 
‘current state andmay fllup fom levels 3 or2 
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T.14LEVEL 0 - Firmware Drivers 
The allophones from level 2 are passed to this level via the interrupt events at level t,o be output to the speech processor when itis ready 
toaccept another allophone, 


‘Two commands ISPSTATUS and I SPOUT, allow the user to interrogate the status of, and to send allophones directly to, the 
speech 0. It is recommended that speech interrupts are off, or that the butter is empty, before using | SPOUT. Otherwise 
allophones from | SPOUT may be randomly interspersed with alophones being output by the speech event 


Level Dis provided primarily for special effects and synchronisation. For example itis only possible to ascertain if a particular allophone 
hhas been spoken by using | SPSTATUS or | SPOUT. 


8 THE COMMANDS IN DETAIL 


B1ISAY 
Use 


To.convertastring of ASCII text into speech. 
Syntax 
ISAY Sting Variable 
Where: 
‘String Variable» represents the string tobe converted. 
example 
‘Say ‘the time is four thirty‘ 
aS = "The time is 4:30" 
ISAY, aaS 


notes 


The speech interrupts are automatically enabled. Any data in the alophone butfer wil therefore be output before the allophones 
Produced by the text to speech system. If the length ofthe string causes the allophione bulter to fil, then the operation of BASIC willbe 
suspended until the entre string has beenconverted. No cistinction is made between upper and lower case. Punctuation is converted 
into pauses of equivalent duration and a short pauseis always sent at the end of each word. 

‘Some common abbreviations, such as ‘Mr’ and ‘Dr’, are converted into ther full word equivalents: ‘mister’ and ‘doctor’. Numbers are 
‘spoken as full as possible such that 10" will be pronounced ‘ten’ instead of ‘one’, ‘zero’. Chapter 5 gives a detaled description of the 
features of te text to speech system. 

The following example willallow youto continually enter the text tobe spoken: 


10 CLS 

20 LINE INPUT “What shall [ say? ";aS 
38 ISAY,aa$ 

4@ PRINT 

58 GOTO 20 


B2IECHO 
use 


‘Activates text to speech conversion on text printed to the screen. Five modes of operation are possible that resutt in printed 
characters being echoed to the speech synthesiser. 


syntax 
1ECHO, <Mode 
Where: 


«Mode: is an integer in the range 0..4 specifying the type of echo to be applied. The default mode after installation is mode 0. The 
modes available are: 


ModeO 


This disables modes 1.4 and restores the original print condition as found during installation, 
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Mode 
Allprint output enclosed between the delimiters ")is spoken AND displayed, 


Mode 2 
Alltext output to the screen, including listings, syntax errors and so onis spoken, contro codes ae stllsent tothe screen. 


Mode 
‘Ailtext output to the screen, including listings, syntax errors and so onis spoken AND displayed 


Mode 4 
Allprnt output enclosed between the delimiters (is spoken but NOT displayed. 


exanple | 
Sayaprogram instead ofistingit. 


lecHo, 2 
LIsT 
TECHo, @ 

notes | 
‘Al 4 modes will watt the allophone bufer fils up. The speech interrupts are automatically enabled. f programs are listed in | 
‘modes 1 or 4 then any text between the delimiters willbe acted upon. Care shouldbe taken to ensure that there is always an even 
‘number of delimiters. 


The delimiter isa") ASCII character 60H 
Lines longer than 80 characters are automatically output. Any text is interpreted in the same way as the [SAY command, 
Chapter gives a detailed account of the features ofthe texto speech system. 
83 |APHONE 
use 
Tossendallophones directly to the interrupt criven allophone buffer, bypassing texto speech conversion. 
syntax 
TAPHONE, <allophone> [-allophone:] 
Where 


<alophone isan integer inthe range 0.63. Valves greater than 63 willbe taken MOD 64. Consecutive allophones may 
‘be sent by separating each with commas. The maximum number of allophones that may be specified at any given time 
islimtedby the length ofa BASIC command ine 


{the butfer becomes ful, then the command will terminate. Ay allophones encountered after the butfer becomes full 
willbe discarded, A check should be made, using | ROOM to ensure there is enough space lef in the bute to accept 
the allophones, before using this command. 


Theallophones will only be heardifthe speech interrupts are on. 
example 

‘Say the word ‘helo’ without using the text to speech system. 

IAPHONE,27,7,62,53,0 


notes 


‘Chapter 4 summarises the allophones available on the SSAt and also presents some guidelines on how to select the 
allophones for particular words. 


84 1ROOK 
‘The | ROOM command may be used to find out how many free locations there are in the allophone butter, whether the 
‘speech synthesiseris curently sounding an allophone, andi the speech interrupts are active. 


syntax 
1 ROOM, @snteger Variable 
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Where: 


«Integer Variable: is the variable into which the result will be passed. 
The result is bit significant: 


Bits 0.5 the number of free locations inthe butter 

Bit 6 indicates the state of the speech interrupts, when set the interrupts are disabled, the butfer wil fil up if any more 
allophones are sent tot. 

Bit7 when set, the speech synthesiser is busy sounding an allophone, 


xa 
‘Say the word ‘hello‘onlyifthere are enough spaces inthe allophone buffer. 
aX=0 
1ROOM, daz 
30 IF (ak and 831) > 5 THEN IAPHONE,27,7,62,53,0 
48 END 
notes 
Ifthe space retumedis zero, then the bufferisfull and any more allophones sent using | APHONE willbe discarded. 
85 1QUIET 
use 
Toclear the allophone bufferto its empty condition and to send a pauseto the speech processor. 
syntax 
1aureT 
Noparameters should be given. 


ON BREAK GOSUB 108 


IQUIET : REM Stop generation of speech 


118 RETURN 

notes 
This command may be issued at any time, regardless of the state of the speech interupts, in order to prevent the 
generation of any speech, due to allophones in the speech butfer waiting to be spoken. 

86 ISPON 

use 
To activate the speech interrupt event. The event allows allophones queued in the allophone buffer to be output 
independently of BASIC. 

syntax 
ISPON 
‘Noparameters should be given. 

notes 
'No allophones from the buffer will be sent to the speech processor until speech events have been activated with this 
‘command. The machine willbe slowed down slightly due to the overhead involved in dealing with the event. The events are 
‘synchronised with the fast ticker. 

87 1SPOFF 

use 
To prevent the output of data from the allophone buffer, This has the reverse effect of 1 SPON, and disables the speech 
interrupt events. 

syntax 
ISPOFF 
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examp) 


notes 


88 ISPSTA 
use 


syntax 


Noparameters should begiven. 
fe 


10 ISPOFF 
28 IAPHONE,27,7,62,53,0 
58 REM Main program follows 


100 ISPON : REM Say the previously stored word 


‘This command willhave no effect unless used after a | SPON command, Any alloshones remaining inthe alophone butter 
willremain intact. The output ofthe data from the allophone butter may be re-commenced by issuing a I SPON command. 
After disabling events the |SP0F F command wil wat for the curently voicing allophone to finish, before sending a 
‘pause, preventing the last allophone from sounding for eve. 


ttisrecommendedthat | SPO F is used whenever speech is not required forlng durations. 
TUS 


Toread the hardware status of te speech processor. 


ISPSTATUS ,aénteger Variable» 


Where: 
«Integer Variable»isa 16 bit nteger into which the status willbe placed. The status iit significant: 


Bit Interpretation 

0.5 Always retums 0, no meaning attached 
6 This is a copy of /LOAD 

7 This is a copy of /BUSY 

8.15. Always returns 0, no meaning attached 


‘Acombination of bts 6 and 7 may be used toascertain the condition ofthe speech processor as ollows: 


76 speech condition 
0 Voicing allophone, 

01 Voicing allophone, DO NOT load next allophone address 
1.0. Not voicing (silent), next allophone address may be loaded 
11 Not produced by the SSAt 


‘example 


notes 
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Wait or allophonesto finish, beore sending another. 


18 at=0 

20 FOR i = 1105 

30 ISPSTATUS ,aa% 

40 WHILE ai AND 64: ISPSTATUS,@a%: WEND 
50 READ b% 
60 [SPOUT ,bx 
70 NEXT i 

80 END 

90 DATA 27,7,62,53,8 


REM No handshaking for |SPOUT 


This command may be used in conjunction with | SPOUT to test for the presence of the SSA1 hardware. A BASIC 
program may use ISPSTATUS to achieve synchronisation with spoken allophones, as may be required during 
animation, 


891 SPOUT 
use 


To send allophones directly to the speech processor, bypassing the allophone butter, One of three handshaking methods 
‘maybe selected, according tothe application, 


syntax 
ISPOUT, allophone: {.<llophone) 


Where: 
-allophone: is a 16 bit integer value in the range 0..256. Only the lower 6 bits are output as address data to the speech 


processor. The valueis interpretedas follows: 


Bit ‘interpretation 
0.5. Allophone nthe range0..63 

6 —__Whenset, selects /BUSY mode of handshaking 
7 Whenset, selects LOAD mode of handshaking 
8.15 Shouldbed 


‘Additionally bits 6 and 7 select one of Shandshake modes in which to output the allophone address, 


7 Mode 
0 Send allophone address immediately, regardless of 

PBUSY or /LOAD. 
1 Sand allophone address when /LOAD active, ignore /BUSY 
0 Send allophone address when /BUSY active, ignore /LOAD 
1 Send allophone address when /BUSY active, ignore /LOAD 


example 
Say ‘hello’ using /BUSY handshaking. 


10 at= 
20 FOR I=1 TO 5 

30 READ b%: bx=bx+128 
40 ISPOUT, bx 

50 NEXT I 

60 END 

70 DATA 27,7,62,53,0 


notes 


‘Speech interrupts should be disabled with | SPF F before using | SPOUT, otherwise tis possible that allopnones may 
‘be randomly interspersed with those being output under interrupt from the allopnone buffer. Although this may be an 
undesirable feature, it can be used to advantage to provide sound effects, in some applications. 


9 ERROR MESSAGES 


(One general error message may be given by any of the commands, ts: 
Bad command 


‘The error may be due to either the incorrect number of parameters, an echo mode that is not in the range 0..4, or an attempt to say a null 
string, 
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APPENDIXA 


‘A.1 Using the SSA1 Software from Machine Code 


‘The commands avaiable with the SSA/ provide allthe necessary facilities for any envisaged application, the commands however are not 
restricted for use with BASIC. As the commands are RSXs they can be caled from within machine code programs, provided the corect 
parameters are passed, exactly the seme as BASIC would pass them. By invoking the RSXs inthis way, the programmer does not needto 
‘know the load adress, or the hardware configuration ofthe SSA, in orderto produce speech. 


From this point on the reader is assumed to have available a CPC464 Firmware Manual. To find out about the interface to an ASK, and 
how the parameters are passed read chapter 9.6 ofthe Firmware Manual. 


‘The desired command is called from a program in a twe stage process. Firstly KL FIND COMMAND is used to obtain the address ofthe 
command. (This firmware call may be used to indicate i the SSA1 software has in fact been installed.) Secondly once the address of the 
command has been established thenthe relevant registers shouldbe set up to correspond to the parameters required by the command, 
and KL FAR PCHL called to invoke the command. it should be assumed that all the primary registers, including Y, are corrupted by the 
RSX commands. 

The following example program shows how to use the {SPOFF command from machine code, it hhould be readin conjunction with the 
fimware manual. 


EXAMPLE: LD. HL, COMMANDS READ ADDRESS OF COMMAND STRING 
CALL KL.FIND.COMMAND ©; SEARCH FOR THE RSX 
JR NC, NOTFOUND 7 NO SUCH COMMAND LOGGED IN 


XOR A j TERO PARAMETERS REQUIRED 
CALL KL. FAR.PCHL 7 INVOKE THE COMMAND 
RET 7 SUCCESSFUL 
COMMANDS: —DEFW "SPOR" 
DEFB "#128 7 COMMAND NAME, LAST CHAR HAS BIT 7 SET 
WOTFOUND: i FAILED TO FIND COMMAND 
‘The same procedure can be used forall the SSA1 commands. Remember that interrupts should not be disabled ifthe allophone buffer is 
tobeused. 
B.1 Driving the SSA‘ Hardware Directly 


in some cases it may be necessary to use the SSA1 without loading the RSX code, for example in a dedicated game. This section 
describes how theSSA\t looks to the programmer and the procedures needed to useit direct. 


8.11 Memory Map 
Tre SSA occupies one addressinthe VO map, a follows: 


ADDRESS INPUT OUTPUT 
OFBEEH STATUS ‘ALLOPHONEDATA 


‘Access to the speech processor is achieved during an UO operation when A10, A¢and AO arelow. That's, VO address OFBEEH, 
The SSA1 generates no hardware interrupts, and must be used in a polledfashion. 


B.12Status Register 
During read, the status of the speech processorisretirned as bit signffcant bit value. The bit postions are assignedasfolows: 


Bit INTERPRETATION 

0-5 Not used, These bits are undefined 

6 /LOAD —Allophone addresses may be sent when LOW 
7 JBUSY When LOW the processor s talking 
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B.13Allophone Address Register 


There are a total of 64 addresses, each corresponding to an allophone. Only bits 0-5 make up the address. Bits 6 and 7 should ALWAYS 
besentasaLOW. 


Allthe allophones in Table 48 are directly supported. 


B.14 Handshaking 
‘There are two possible methods of sending allophone addresses to the speech processor, both make use of poling the STATUS register. 


1] Allophones may be written consecutively one after another whenever /LOAD is LOW. The speech processor will allow 
another allophone to be loaded whilst itis still sounding a previous allophone, its readiness to accept the next allophone is. 
indicated by the /LOAD signal. 


2] New data may be written after a preceding allophone has been completely spoken. This is achieved by writing data only 
when /BUSY is HIGH. In this case there is only ever one allophone outstanding, waiting to be spoken. The speech may be 
terminated at any time between successive allophones, by sending a pause to the processor. A suitable procedure for 
loading data using /BUSY handshakingis: 


BEGIN 
READ STATUS 
WHILE /BUSY=@ 
READ STATUS 
WEND 
OUTPUT ALLOPHONE 
ND 


el 
‘This method of handshaking isrecommended. 


‘The last part of the last allophone spoken willbe continuously repeated, until another allophone is addressed. A PAUSE should be sent as 
the last allophone of any group, to stop the speech processor generating noise. 


APPENDIX C 


C.1 Hardware Operation 
‘The operation of the SSA1 can be functionally subdivided into two sections; one digital; the other analogue. Figure C1 outlines their 
association. 


C.11 Digital 


‘The digital section comprises four integrated circuits, one is the SP0256-AL2 allophone speech processor from Gi, The remaining three 
‘complete the interface of the speech processor to the CPC 464 expansion bus. 


‘Whenever an i/o readis performed with A10, Ad and AO low, two tri-state butters connected to the data lines D7 and D6 are enabled. The 
inputs to these buffers are connected to the SBY and /ALD handshake lines of the speech processor. The SBY signal is referred to as 
(BUSY and /ALDis referred to as /LOAD throughout this quide. 


Allophone addresses are loaded whenever an /o write is performed with A10, A4 and AO low. 


C.12 Analogue 
‘Two separate audio amplifiers are used to provide a stereo output of up to 200mW per channel into 4 ohms. 


The stereo output from the CPC464 is mixed with the speech before being amplified. A SOUND command with a volume level of 15 
‘produces an output of 200mW into a 4 ohm load at full volume. 


The digital output from the speech processor, a 40kHz pulse width modulated signal, is low pass filtered at SkHz and then fed 
‘symmetrically to each channel, Atfull volume the speech will generate 200mW into 4 ohms. 


The operation of the computer may be heard through the loudspeakers on occasions, this is due stray pickup of computer generated 
‘noise manifesting itse in the same way as that heard on the computer's internal loudspeaker. 
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APPENDIX D 


DIGITAL, 


ANALOGUE 


‘STREREO 
FROMCPCA64 


.1 niialising the SSA1 Software 


i itis possible to load the SSA software from within ancther program, infact thisis what the loader program does. To load the software 
you must frst reserve an area of memory into which the code isto be loaded. The loader program wil tll youhow much space will be 
‘equired. Let the load address be BASE, the fllowinglines of BASIC wilload, relocate andiniilise the SSA1 sotwar: 


1B LOAD "SSA1.BIN" BASE 


20 START=BASE+PEEK (BASE) +PEEK(BASE+1)*256 


30 CALL START 


The frst word of the programis the offset from BASE tothe start of the relocation routine. Ths is added to BASE to obtain START, which 
isthen calledto relocate andlog onthe software, 


D.2 Testing for the SSA1 Hardware 


lfyou.are driving the hardware without the SSA\ softwere, or the softwarehas been loaded without the using the loader program, thenit 
is desirable o know fthe SSA hardware isin fact connected. The following procedure outines how to test for the hardware. 
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BEGIN 
READ STATUS REGISTER 
(+ Bit 7 should be 1, bit 6 at @ *) 
IF STATUS AND @CBH = 88H THEN 
(+ So far so good, now send sone data *) 
DATA = 3 (* 10@mS pause *) 
OUTPUT DATA TO ADDRESS REGISTER 
(* Bit 7 should now go to @ *) 
READ STATUS REGISTER 
IF STATUS AND 88H = @ THEN 
SUCCESS (* Hardware functions *) 
ELSE 
FAIL (* Not there ? *) 


ELSE 
FAIL (# Not there ? *) 
END 


The above procedure can be implemented either in machine code, BASIC, or by using the SPOUT and I SPS TATUS commands. 
Obviously if the SSA1 code has not been loaded, then it will be necessary to directly address the hardware. The program below checks 
forthe hardware by sending a pause and testing to see if the /BUSY iinehas gone ow. 


10 ssatz=8FBEE 

d%= INP(ssa1%) AND &CO 

IF d%<>880 THEN 78 

OUT ssa1%,3 

d%= INP(ssa1%) AND &CO 

If d%=B then PRINT "Hardware 01 
PRINT "Hardware not working 27? 


0.3 Testing for the SSA1 Software 


‘Sometimes itis useful for a program to know i the SSA1 software has been installed. A BASIC program can determine if the software is 
present by issuing any one ofthe commands, and trapping any error messages. An error 28, ‘Unknown command’ willbe generated the 
software has not been installed. The program below shows how this is done. 


END 
: END 


18 ON ERROR GOTO 50 

28 1QUIeT 

30 PRINT “Software installed” 

48 END 

5@ IF ERR=28 THEN PRINT “No SSA1 software installed” 
68 END 


D.4Further examples 
‘Another example program lets you write up to9 different phrases which can then either be spoken, or overwritten: 


18 CLS 

20 PRINT:PRINT "Press W to Write, press -S$ to Say" 
30 IF INKEY(59)<>-1 THEN 50 

40 IF INKEY(6Q)<>-1 THEN 80 ELSE 30 

50 PRINT "WRITE which"; :GOSUB 11 
68 PRINT “Now enter phrase number’ 
78 GOTO 28 

88 PRINT "SAY which";:GOSUB 110 

THEN PRINT “Nothing to say!" ELSE ISAY,ap$(n) 


LINE INPUT pS(n) 


118 PRINT " phrase number (1 to 9)? 


120 aS=INKEYS:1F a$="" THEN 128 
138 n=VAL(a$):IF n<1 THEN 128 ELSE PRINT n 
1 


RETURN 
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